home *** CD-ROM | disk | FTP | other *** search
/ Windows Game Programming for Dummies (2nd Edition) / WinGamProgFD.iso / pc / DirectX SDK / DXSDK / samples / Multimedia / DirectShow / Players / CutScene / readme.txt < prev   
Encoding:
Text File  |  2001-10-10  |  1.2 KB  |  33 lines
  1. DirectShow Sample -- CutScene
  2. -----------------------------
  3.  
  4. Usage:
  5.  
  6.     cutscene <media filename>
  7.  
  8. Description:
  9.  
  10.     Cutscene is a simple fullscreen movie player sample that enables you to
  11.     add movie playback to your application without needing to learn the 
  12.     specifics of DirectShow programming.
  13.  
  14.     The application's WinMain() calls PlayCutscene(), a generic function that 
  15.     you can use to add easy playback of movies or cutscenes to the beginning 
  16.     of your game.  All of the code needed for movie playback is contained 
  17.     within cutscene.cpp and cutscene.h and can be added to your project.
  18.  
  19.     Cutscene creates a hidden window to handle keyboard input.  A user can 
  20.     press SPACE, ENTER, or ESCAPE keys to cause the playback to end.  
  21.     When playback ends, the window is destroyed.
  22.  
  23. Return values:
  24.  
  25.     If movie playback continues to the end without error, 
  26.         PlayCutscene() returns S_OK.
  27.  
  28.     If movie playback is interrupted by the user, PlayCutscene returns S_FALSE.
  29.         (S_FALSE is not an error and will not fail in the FAILED() macro.)
  30.  
  31.     If there is an error, PlayCutscene returns an HRESULT error code.
  32.  
  33.